Pull request overview

This PR restructures several Community Toolkit host-only integration docs (Deno, Java, k6, Perl, PowerShell, Rust, SQL Database Projects) by replacing the prior single-page entries with paired get-started and AppHost reference pages, and then updates routing/mapping so the gallery, sidebar, and legacy links point at the new structure.

Changes:

• Replaces legacy single-page integration docs with new *-get-started.mdx and *-host.mdx pages for the listed host-only integrations (and removes the old landing pages).
• Updates docs routing infrastructure: integration docs mapping (integration-docs.json), sidebar topics, and redirects to preserve old URLs.
• Adjusts icon safelist entries.

Reviewed changes

Copilot reviewed 25 out of 25 changed files in this pull request and generated 17 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

📋 Docs-accuracy review (doc-pr-reviewer)

Verdict: COMMENT — non-blocking. The documentation is accurate against source and renders cleanly; only benign scoping nuances are noted below.

Summary

No contradicted or unverifiable claims were found, so there are no inline change requests. Core Aspire APIs referenced by the samples (WithReference, WaitFor, WithHttpEndpoint, WithBindMount, WithExternalHttpEndpoints, TS AppHost generation, etc.) live in microsoft/aspire rather than the Community Toolkit and were treated as standard/core — most of the "verified-with-nuance" verdicts are just that attribution note, not a documentation defect.

Phase A — Claim verification

0 contradicted · 0 unverifiable. Every C#/TypeScript API, package id, CLI command, config key, endpoint/port, redirect, and mapping was matched string-for-string against the Community Toolkit source at the pinned commit. A sample of the more specific claims was independently re-verified against source, e.g.:

• k6 — K6Port = 6565, .WithHttpEndpoint(targetPort: K6Port, …), .WithHttpHealthCheck("/health"), WithK6OtlpEnvironment copying OTEL_* → K6_OTEL_*. ✔️
• Java — [AspireExport("addJavaAppWithJar")] overload + JarPath ([AspireExport(ExposeProperties = true)]); WithMavenBuild/WithGradleBuild defaults clean package / clean build. ✔️
• PowerShell — defaults PSLanguageMode.ConstrainedLanguage, minRunspaces = 1, maxRunspaces = 5, with [AspireExportIgnore] on the PSLanguageMode overload (matches the "not TS-exported; string bridge validates enum names" note). ✔️
• SQL Database Projects — AddSqlProject, AddSqlPackage<TPackage> (C#-only generic), WithDacpac, WithDacDeployOptions / WithConfigureDacDeployOptions (C#-only), WithSkipWhenDeployed. ✔️
• Perl — WithLocalLib env (PERL5LIB, PERL_LOCAL_LIB_ROOT, PERL_MM_OPT, PERL_MB_OPT), WithPerlCertificateTrust (SSL_CERT_FILE, PERL_LWP_SSL_CA_FILE, MOJO_CA_FILE), WithPerlbrew. ✔️
• Host-only / no-connect claim — confirmed: the CTK src/ tree ships only hosting packages for k6, SqlDatabaseProjects, Deno, Java, Perl, PowerShell and Rust; there is no companion CommunityToolkit.Aspire.<X> client package, so "these host-only integrations intentionally have no connect pages" holds.
• Config/data — all 7 redirects, the sidebar topic slugs, and the integration-docs.json package→route mappings point at the 14 new files, which all exist.

🟡 Nuance worth a glance (non-blocking)

• frameworks/perl/perl-get-started.mdx (~L51-57): the prerequisites imply cpanm is needed for project dependencies. Per source, project-dependency installation via Carton does not require cpanm — you may want to phrase it as "cpanm is required for WithCpanMinus, WithLocalLib, or non-Carton project dependencies."
• A few "verified-with-nuance" items assert an absence (e.g., PowerShell scripts have "no WithWorkingDirectory", host-only integrations emit "no publish artifact"). These are correct as evidenced by the absence of the corresponding API / publish callback in source, rather than by an explicit source statement — flagging only so the wording isn't read as an explicitly-documented guarantee.

Phase B — doc-tester results (blind rendering validation)

Served PR #1377 head (c33bbc67) from a local pnpm dev server and navigated exclusively with a browser (no source code consulted). Routes exercised: all 14 new pages and all 7 redirects, plus tab-synchronization and theme-logo behavior.

Critical issues

None.

Warnings

None.

Passed checks

• All 14 pages render with the expected title, the ⭐ Community Toolkit badge, a logical heading hierarchy, and their hero logo (e.g. k6 374×362, Perl camel 1500×1500, PowerShell/Rust/Deno/SQL 100×100, Java 54×100).
• All 7 redirects return 301 to the correct new route (deno-apps → deno/deno-get-started, java/perl/powershell/rust → …/*-get-started, k6 → k6/k6-get-started, sql-projects → sql-projects/sql-projects-get-started).
• Synchronized AppHost tabs work — the four aspire-lang (C# / TypeScript) tab groups on the Deno host page all switched to TypeScript when one was toggled, while the independent aspire-install group stayed put.
• Theme-aware Deno artwork is wired via the theme-image class (light/dark variants), matching the PR's "theme-specific Deno artwork" note.
• No console errors on any page; no expressive-code/twoslash error markers; no broken raster images.
• Internal cross-links between each integration's get-started and host page (and to /get-started/*, /reference/cli/*, /deployment/*, /integrations/overview/) resolve to real routes.
• Get-started prose reads well for a newcomer: intro → "how it works" → prerequisites → first resource (C#/TypeScript) → see also.

Recommendations

• Minor (mirrors the Phase A nuance): on the Perl get-started page, clarify that cpanm is only required for WithCpanMinus/WithLocalLib/non-Carton project dependencies.

Knowledge gaps / scope limitations

• Runtime execution was not performed. This review validated rendering, structure, links, redirects, and tab behavior in the browser, and verified every API/config claim against Community Toolkit source (Phase A). It did not re-run the actual AppHost samples end-to-end, which would require installing the Deno, JDK+Maven/Gradle, Perl+cpanm/Carton, PowerShell SDK, Rust/Cargo+Bacon, k6, and SqlPackage toolchains. The PR body states fresh external C#/TypeScript samples were restored and compiled/type-checked for all seven integrations; that build evidence was taken as-is and not independently reproduced here.

_{Automated review via the doc-pr-reviewer skill (Phase A: claim verification vs. source · Phase B: doc-tester browser validation). No files in the PR, the docs repo, or any source clone were modified.}